home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / compress / arclb193.zip / ARCLAB.DOC next >
Text File  |  1992-11-02  |  14KB  |  328 lines
  1. <ArcLab.doc V 1.93 2/11/92>
  2. What's new since last time ?
  3. ****************************
  4.  
  5. 1.93    2/11/92 bug correction: when there was an error, the log was not
  6.         created properly.
  7.  
  8.  
  9. History
  10. *******
  11. I'm running a BBS and i wanted to have all the files in one format only
  12. for the user's convenience and mine. I've been using lots of packer and
  13. unpackers but none of them could function in unattended mode (batch
  14. mode). So i wrote this. The purpose is simple: I run this after any
  15. upload in the upload directory. When i come back i just have to shuttle
  16. the file and the description to the right directory. No sweat ! By
  17. default the whole directory is analyzed and treated. Arclab used to be
  18. called ConvArc until V 0.95. All versions have been running on my BBS
  19. until the next version release. (in other words, it is safe).
  20.  
  21. Release
  22. *******
  23. full history: see arclab.rev
  24.  
  25. 0.50   17/01/92 first really working version of ConvARC. Treats the whole
  26.        directory, not processing LZH or unrecognized extentions. The
  27.        recognition processed is not intelligent yet. Params not quite
  28.        treated either but working enough for my purpose (massive
  29.        conversion)
  30.  
  31. 1.00ß  20/02/92 ConvARC becomes ARC lab 1.00. Major differences:
  32.  
  33.        1) the arc recognition is now smart: the recognition is done
  34.        after analysis of the arc, not according to extention as it used
  35.        to be. It allows batch processing of SDS/SDN/WinNet files or
  36.        anything for that matter. If a LZH archive is found, it analyses
  37.        the level of compression. If it is < 4 it will repack the
  38.        archive.
  39.  
  40.        2) There is a config file where you can store once and for all
  41.        all the options that used to be on the config line. The config
  42.        file MUST RESIDE in the SAME directory as ArcLAB.EXE !!!!!
  43.        Otherwise the prog won't find it !
  44.  
  45. 1.10ß  22/02/92 Features added:
  46.        a) now displays type of conversion
  47.        b) PAK now supported => new K switch added
  48.        c) better looking output
  49.        d) Other options added in config file:
  50.          O(ther):
  51.        you can specify there an action that will take place IN THE
  52.        TEMPORARY DIRECTORY WHERE THE UNPACKING IS DONE. This option is
  53.        to be used with great care: you can easily run out of memory
  54.        BUT the reason for this option is to be able to call ARCLAB
  55.        itself again ! to treat other arc inside the arc. Explanation: if
  56.        you a big.zip containing smal1.zip and smal2.zip can now be
  57.        treated. However, be aware that
  58.          1) the config file will be used !
  59.          2) the options will be treated in the order of their
  60.          appeareance. So my suggestion is
  61.          ligne option 1 make a swap of the config
  62.          ligne option 2 if exists *.zip arclab
  63.          ligne option 3 if exists *.pak arclab
  64.          ligne option 4 if exist *.zip del *.zip
  65.          ligne option 5 if exist *.pak del *.pak
  66.          ligne option 6 deletes the arclab.log
  67.                 (otherwise packed in the arc!
  68.          ligne option 7 make a swap of the config
  69.          or something in the way of.
  70.          V(IROK): message displayed if virus test showed nothing special
  71.          N(OTOK): message displayed if virus test failed
  72.          K(ILL VIR): action to be taken if virus found.
  73.          again this option is to be used with great care. Already
  74.          available are the production of a  file: ALARM.FFT, an entry
  75.          is written in the log and the program exits IMMEDIATELY
  76.          with error level 666. The existence of the file can be checked
  77.          by the "if exist alarm.fft " of the dos and the 666 errorlevel
  78.          can be recovered and treated in a batch.
  79.  
  80. =>=>=>   It is voluntarily that i do NOT recurse the directory to change
  81.  NOTE    all archive found into whatever you want. Some programs are
  82. =>=>=>   distributed with an install procedure that will NOT work if the
  83.          archive has been repacked (Qmodem, dBridge, etc). I provide a
  84.          way to do it, but YOU take the responsability of repacking.
  85.  
  86. 1.20    25/02/92 special request from Dino Vander.Roost, sysop of Media
  87.         Concept (2:293/3400): update the Files.bbs or any other file if
  88.         the P switch is found in config file.
  89.  
  90. 1.40    28/02/92 special request from Georges Troupin, sysop of Mosacom:
  91.         I added 2 options in the config file to eXclude some files from
  92.         conversion.
  93.  
  94. 1.50    29/02/92 multi lingual config added.
  95.  
  96. 1.90 *  30/09/92 exclusion bug again, this time for good I hope. The
  97.         skip routine if not enough space left is also rewritten.
  98.         Added 3 messages in config: U scanning message, W unpacking
  99.         message and Y packing message. Gives a bit more indication about
  100.         what is going on. Optimized also.
  101.  
  102. 1.92    16/10/92 bug correction in error trapping. The log is now
  103.         written before exitting if there is a problem. The maximum
  104.         number of files to be treated is jacked up to 1250 and the
  105.         maximum number of files added, changed, killed or excluded is up
  106.         to 500 each by converting part of variable to pointers instead
  107.         of arrays.
  108.  
  109. 1.93    2/11/92 bug correction: when there was an error, the log was not
  110.         created properly.
  111.  
  112. Technical stuff
  113. ****************
  114. This is written using Turbo Pascal 6.0 (Tm of Borland).
  115. 1675 lines source code for about 43 k. (not counting
  116. includes)
  117.  
  118. Source code availability
  119. *************************
  120. source code is not available: it is dull, long and unecessarily
  121. complicated. Get High: write your own !
  122.  
  123.  
  124. Disclaimer
  125. **********
  126. The only thing I can guarantee is that this program will take up space on
  127. your hard disk. The rest is beyond my control. Use it at your own risks,
  128. i don't wanna hear about it. To the best of my knowledge, this program
  129. shoudln't harm your hardware or software in any way. Arclab has been
  130. used in batch mode with no problem for months on my BBS and there is no
  131. reason it shoudn't function in the same flawless way on your machine.
  132. However, if there be any problem, i shall in no case be liable for
  133. anything. (How's that for a disclaimer !).
  134.  
  135. =>> ßeta policy:
  136. ****************
  137. if a version carries the ßeta sign, it means it has not been fully
  138. tested. The version might actually work flawlessly in 99 % of the cases
  139. but again it might not. In any case, ALL BETA VERSION WILL COMMIT
  140. SUICIDE AT THE LATEST ON THE MARCH 4TH FOLLOWING THEIR RELEASE. A beta
  141. version is usually what it implies: a program not finished yet and i
  142. don't want unfinished programs on the loose. If you get a beta and don't
  143. see a normal realease appearing afterwards and would like to continue
  144. using the product, just netmail me or download it from CTServe
  145. (2:270/25). Media Concept (2:293/3400) and usually Tornado (292/600)
  146. also carry my softs.
  147.  
  148. Registration
  149. ************
  150. This is not free software and it is copyrighted Thunus F. 1992.
  151.  
  152. This is ShareWare, so if you continue to use it for more than 30 days,
  153. you should register by sending $20 or 400BEF or 20DM or 50FF to
  154.  
  155.       Thunus F. 43 rue des Ateliers, B-6792 Halanzy Belgium
  156.  
  157. You will receive a code number that will deactivate the shareware
  158. notice, the annoyance delay and include your name in the output (if any)
  159. of the program. Registration can be made for any name or string of
  160. character up to 30 char long. Failure to register means bad karma.
  161.  
  162.  
  163. Installation
  164. ************
  165. This archive should contain the following files:
  166.  
  167. ArcLab.exe  (59680)
  168. ArcLab.doc  quick doc
  169. Arclab.rev  revision history (with usefull info !)
  170. ArcLab.fft  sample config file
  171.  
  172. This software will convert anything in anything or almost. I support
  173. ARJ, LZH, PAK, ZIP, ARC, ZOO and SQZ. When a file of this type is
  174. recognized and unless it is on the exclusion list, it will be
  175. transformed in any of the other format you choose except SQZ. Optionnaly
  176. the files.bbs will be updated or any other file. You can also delete
  177. some files from the archive and add some others, and place you banner in
  178. the commentary section of the arc if it is supported.(see arclab.rev for
  179. zoo limitation). The content of the file is also scanned for virus and
  180. action to be taken in case it is found is up to you. I suggest you have
  181. a look at the sample config file to see all the possibilities. You can
  182. replace all messages by your own, treat a whole dir at the time or just
  183. one file, etc.
  184.  
  185. ALL PACKERS AND UNPACKERS MUST BE ACCESSIBLE TO DOS (ie in path: ARJ,
  186. ZOO, LHA, PKzip, PKunzip, PKpak, PKunpak, ETC). You can also pass as
  187. param 1 Z, J, A, O, K or L for zip, arj, pkpak, zoo, PAK or Lha. Zip is
  188. 1.10, arj was tested with 2.13 and 2.3, pkpak is last version, zoo
  189. tested with 2.10 but should work with previous to unpack. The packing is
  190. done with h switch (2.10 and up only). PAK was tested with 2.50 and
  191. 2.51, lha is 2.13 and default. If param 1 is a valid filename, only that
  192. file will be treated. You can then pass Z,A,O, K, L or J as second
  193. parameter.(or S if you want a sound when work is done).
  194.  
  195.  
  196. summary:
  197. set scan='c:\virus\myprog.exe'
  198. set scanpar='my PaRaMs'
  199. ┌─────────────────────────────────────────────────────────────────────────────┐
  200. │ Parameter 1: path to arc or conversion type (like 2)(default = all dir)     │
  201. │ Parameter 2: op: Z=PKZIP * A=PKPAK * J=ARJ * O=ZOO * K=PAK * L=LHA (default)│
  202. │ Parameter 3: s means sound wanted: sounds when finished                     │
  203. └─────────────────────────────────────────────────────────────────────────────┘
  204.  
  205. examples:
  206. ArcLab test.zip (into lha)
  207. ArcLab test.lzh Z (into zip)
  208. ArcLab test.lzh Z s (into zip and sound when done)
  209. ArcLab J (all directory into ARJ)
  210. ArcLab s (all directory into lharc and sound when done)
  211.  
  212. or a config file named ARCLAB.FFT like:
  213.  
  214. ; Config file for ARClab 1.90 (C) Thunus F. 1992
  215. ; redefinition of default screen messages:
  216. ; "switch" means toggle an option ON or OFF
  217. ; "File" means the name of a file is expected to begin
  218. ;  on the 4th position
  219. ; 1  Converting into :
  220. ; 2  Sound Option is :
  221. ; 3  Virus Killer    :
  222. ; 4  No Virus msg    :
  223. ; 5  Virus Found msg :
  224. ; 6  Virus Action    :
  225. ; 7  Patching        :
  226. ; 8  Adding file     :
  227. ; 9  In temp doing   :
  228. ; A means ADD a file to the arc (typically a banner) (max 50) (file)
  229. ; B Brutal (ie STRICT) Check to exclude file from treatment. (file)
  230. ;   a couple of explanations: X scan86.zip and B means that if scan86.zip
  231. ;   is found, it will not be treated. The difference between the 2 is in
  232. ;   the coding: for B i do this: If (nomarc.ext)=(confignam.ext) then
  233. ;   begin   Faire:= false;exit;end; No if , but or whatever.
  234. ;   IT IMPLIES YOU MAY NOT USE WILDCARDS WITH B OPTION.   The X option
  235. ;   however, is much more sophisticated; i'm looking for wildcards, etc I.E.
  236. ;   SLOWER, which is why i kept the 2. If there is a file you know about
  237. ;   or have been warned about and know the name 200% for sure, then use B.
  238. ;   Else, use X
  239. ; C  Not converting  :
  240. ; (no conversion message)
  241. ; D  name of the file to be deleted (file)
  242. ; E  Deleting :
  243. ; (deleting message)
  244. ; F  restore date of the archive converted default:= off (switch)
  245. ; H name of the banner file (file)
  246. ; I  Banner file is  :
  247. ; (banner message)
  248. ; K is the action to be take when the virus is found (file)
  249. ; L means limit the output to minimum (switch)
  250. ; M  Turns the music (ie Sound) on. (switch)
  251. ; N is the message when virus scan failed
  252. ; O is any action to be taken IN THE TEMP DIR (max 50)
  253. ; P means patching Files.bbs or file given as argument (switch)/(file)
  254. ; Q quiet mode: switches of display of msg 4 and 5
  255. ; S is followed by the scanning option and overrides any other setting,
  256. ;    including the scan and scanopt environement variables
  257. ; T  is the type of conversion wanted: default is LZH. Valid options are:
  258. ;    Z O J A L K (Zip, zOo, arJ, Arc, Lzh, paK) (switch)
  259. ; U  is the scanning message
  260. ; V is the message displayed when virusscan OK
  261. ; W is the unpacking message
  262. ; X means exclude this file from treatment. Wildcards admitted
  263. ; Y is the packing message
  264. ;
  265. ; ┌──────────────────────────────────────────────────────────────────────────┐
  266. ; │                                                                          │
  267. ; │ For all   switches, the name and path of file MUST start on 4th position │
  268. ; │                                                                          │
  269. ; └──────────────────────────────────────────────────────────────────────────┘;
  270. ;
  271.  
  272.  
  273. Kudos / ACK
  274. ************
  275. - Frank Van Uffelen, sysop of Tornado BBS Belgium. By sending me about 170
  276. Megas on tapes to put on my bbs he gave me the idea to write this. His
  277. files were a NICE mixture of every kind of archive you can dream of !
  278. :=) Hi Frank !
  279.  
  280. - Turbo Pascal is a trademark of Borland International.
  281. - IBM is a trademark of International Business Machines Corporation.
  282.                   (this line is intentionally left blank)
  283. - MS-DOS is a trademark of Microsoft Corporation.
  284. - Windows, by the people who brought you EDLIN (sorry couldn't resist)
  285. - ARc is definitely a trademark of SEA
  286. - Pak is a Trademark of Nogate Consulting.
  287. - PKZIP and PKPAK are trademarks of PKWARE
  288. - LHARC is (C) Yoshi
  289. - ARJ is (C) Robert K. JUNG
  290. - ZOO is (C) Rahul Dhesi
  291. - Dino Vander.Roost, sysop of Media Concept for suggestions and support
  292. - Georges Troupin, sysop of Mosacom for suggestions.
  293.  
  294. Just in case I left anyone out, here is a global acknowledgement of
  295. copyright:
  296.  
  297. *.*  is a  copyright /  trademark /  service  mark /  trade name  / pet
  298. project / patent of *.*, All rights reserved.
  299.  
  300. Support
  301. ********
  302. Support and registration :
  303. You can reach me @ CTServe: + 352 45 26 65 (8N1) 24h
  304. AKA SysOp or FidoNet 2:270/25 or 2:270/25.1
  305. or Francois@fido.lu on Internet
  306. or by snailmail to
  307.  
  308. Thunus F.
  309. 43 rue des Ateliers
  310. B-6792 Halanzy
  311. Belgium
  312.  
  313. No Voice Phonecall please ! all netmail will be answered.
  314.  
  315. If ((comment > 0) or (happiness > 0)) then
  316.     begin
  317.      NetMail:=NetMail+1;
  318.      Happiness_programmer:=Inc(Happiness_programmer);
  319.     end;
  320.   If Happiness > 0 then repeat
  321.      inc(programming);
  322.      shareware:=shareware++;
  323.      until NMI;
  324.  
  325. Drop also a line to give feedback. I've been known to hang around pascal
  326. conference in various bbs amongst which the superb Media Concept in
  327. Belgium as well as PC AArhus (Denmark).
  328.